home *** CD-ROM | disk | FTP | other *** search
/ Total Network Tools 2002 / NextStepPublishing-TotalNetworkTools2002-Win95.iso / Archive / Misc Servers / Zope.exe / TRAVERSABLE.PY < prev    next >
Encoding:
Python Source  |  2000-08-15  |  8.5 KB  |  224 lines
  1. ##############################################################################
  2. # 
  3. # Zope Public License (ZPL) Version 1.0
  4. # -------------------------------------
  5. # 
  6. # Copyright (c) Digital Creations.  All rights reserved.
  7. # 
  8. # This license has been certified as Open Source(tm).
  9. # 
  10. # Redistribution and use in source and binary forms, with or without
  11. # modification, are permitted provided that the following conditions are
  12. # met:
  13. # 
  14. # 1. Redistributions in source code must retain the above copyright
  15. #    notice, this list of conditions, and the following disclaimer.
  16. # 
  17. # 2. Redistributions in binary form must reproduce the above copyright
  18. #    notice, this list of conditions, and the following disclaimer in
  19. #    the documentation and/or other materials provided with the
  20. #    distribution.
  21. # 
  22. # 3. Digital Creations requests that attribution be given to Zope
  23. #    in any manner possible. Zope includes a "Powered by Zope"
  24. #    button that is installed by default. While it is not a license
  25. #    violation to remove this button, it is requested that the
  26. #    attribution remain. A significant investment has been put
  27. #    into Zope, and this effort will continue if the Zope community
  28. #    continues to grow. This is one way to assure that growth.
  29. # 
  30. # 4. All advertising materials and documentation mentioning
  31. #    features derived from or use of this software must display
  32. #    the following acknowledgement:
  33. # 
  34. #      "This product includes software developed by Digital Creations
  35. #      for use in the Z Object Publishing Environment
  36. #      (http://www.zope.org/)."
  37. # 
  38. #    In the event that the product being advertised includes an
  39. #    intact Zope distribution (with copyright and license included)
  40. #    then this clause is waived.
  41. # 
  42. # 5. Names associated with Zope or Digital Creations must not be used to
  43. #    endorse or promote products derived from this software without
  44. #    prior written permission from Digital Creations.
  45. # 
  46. # 6. Modified redistributions of any form whatsoever must retain
  47. #    the following acknowledgment:
  48. # 
  49. #      "This product includes software developed by Digital Creations
  50. #      for use in the Z Object Publishing Environment
  51. #      (http://www.zope.org/)."
  52. # 
  53. #    Intact (re-)distributions of any official Zope release do not
  54. #    require an external acknowledgement.
  55. # 
  56. # 7. Modifications are encouraged but must be packaged separately as
  57. #    patches to official Zope releases.  Distributions that do not
  58. #    clearly separate the patches from the original work must be clearly
  59. #    labeled as unofficial distributions.  Modifications which do not
  60. #    carry the name Zope may be packaged in any form, as long as they
  61. #    conform to all of the clauses above.
  62. # 
  63. # 
  64. # Disclaimer
  65. # 
  66. #   THIS SOFTWARE IS PROVIDED BY DIGITAL CREATIONS ``AS IS'' AND ANY
  67. #   EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  68. #   IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  69. #   PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL DIGITAL CREATIONS OR ITS
  70. #   CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  71. #   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  72. #   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  73. #   USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  74. #   ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  75. #   OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  76. #   OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  77. #   SUCH DAMAGE.
  78. # 
  79. # 
  80. # This software consists of contributions made by Digital Creations and
  81. # many individuals on behalf of Digital Creations.  Specific
  82. # attributions are listed in the accompanying credits file.
  83. # 
  84. ##############################################################################
  85. '''This module implements a mix-in for traversable objects.
  86.  
  87. $Id: Traversable.py,v 1.2.2.2 2000/08/15 17:06:55 evan Exp $'''
  88. __version__='$Revision: 1.2.2.2 $'[11:-2]
  89.  
  90.  
  91. import Acquisition
  92. from AccessControl import getSecurityManager
  93. from string import split, join
  94. from urllib import quote
  95.  
  96. _marker=[]
  97. StringType=type('')
  98.  
  99. class Traversable:
  100.  
  101.     absolute_url__roles__=None # Public
  102.     def absolute_url(self, relative=0):
  103.         try:
  104.             req = self.REQUEST
  105.         except AttributeError:
  106.             req = {}
  107.         rpp = req.get('VirtualRootPhysicalPath', ('',))
  108.         spp = self.getPhysicalPath()
  109.         i = 0
  110.         for name in rpp[:len(spp)]:
  111.             if spp[i] == name:
  112.                 i = i + 1
  113.             else:
  114.                 break
  115.         path = map(quote, spp[i:])
  116.         if relative:
  117.             # This is useful for physical path relative to a VirtualRoot
  118.             return join(path, '/')
  119.         return join([req['SERVER_URL']] + req._script + path, '/')
  120.  
  121.     getPhysicalRoot=Acquisition.Acquired
  122.     getPhysicalRoot__roles__=() # Private
  123.  
  124.     getPhysicalPath__roles__=None # Public
  125.     def getPhysicalPath(self):
  126.         '''Returns a path (an immutable sequence of strings)
  127.         that can be used to access this object again
  128.         later, for example in a copy/paste operation.  getPhysicalRoot()
  129.         and getPhysicalPath() are designed to operate together.
  130.         '''
  131.         path = (self.id,)
  132.         
  133.         p = getattr(self,'aq_inner', None)
  134.         if p is not None: 
  135.             path = p.aq_parent.getPhysicalPath() + path
  136.  
  137.         return path
  138.  
  139.     unrestrictedTraverse__roles__=() # Private
  140.     def unrestrictedTraverse(self, path, default=_marker, restricted=0):
  141.  
  142.         if not path: return self
  143.  
  144.         get=getattr
  145.         N=None
  146.         M=_marker
  147.  
  148.         if type(path) is StringType: path = split(path,'/')
  149.         else: path=list(path)
  150.  
  151.         REQUEST={'TraversalRequestNameStack': path}
  152.         path.reverse()
  153.         pop=path.pop
  154.         if restricted: securityManager=getSecurityManager()
  155.         else: securityManager=None
  156.  
  157.         if not path[-1]:
  158.             # If the path starts with an empty string, go to the root first.
  159.             pop()
  160.             self=self.getPhysicalRoot()
  161.             if (restricted and not securityManager.validateValue(self)):
  162.                 raise 'Unauthorized', name
  163.                     
  164.         try:
  165.             object = self
  166.             while path:
  167.                 name=pop()
  168.  
  169.                 if name[0] == '_':
  170.                     # Never allowed in a URL.
  171.                     raise 'NotFound', name
  172.  
  173.                 if name=='..':
  174.                     o=getattr(object, 'aq_parent', M)
  175.                     if o is not M:
  176.                         if (restricted and not securityManager.validate(
  177.                             object, object,name, o)):
  178.                             raise 'Unauthorized', name
  179.                         object=o
  180.                         continue
  181.  
  182.                 t=get(object, '__bobo_traverse__', N)
  183.                 if t is not N:
  184.                     o=t(REQUEST, name)
  185.                     
  186.                     # Note we pass no container, because we have no
  187.                     # way of knowing what it is
  188.                     if (restricted and not securityManager.validate(
  189.                         object, None, name, o)):
  190.                         raise 'Unauthorized', name
  191.                       
  192.                 else:
  193.                     o=get(object, name, M)
  194.                     if o is not M:
  195.                         if restricted:
  196.                             # waaaa
  197.                             if hasattr(get(object,'aq_base',object), name):
  198.                                 # value wasn't acquired
  199.                                 if not securityManager.validate(
  200.                                     object, object, name, o):
  201.                                     raise 'Unauthorized', name
  202.                             else:
  203.                                 if not securityManager.validate(
  204.                                     object, None, name, o):
  205.                                     raise 'Unauthorized', name
  206.                         
  207.                     else:
  208.                         o=object[name]
  209.                         if (restricted and not securityManager.validate(
  210.                             object, object, None, o)):
  211.                             raise 'Unauthorized', name
  212.  
  213.                 object=o
  214.  
  215.             return object
  216.  
  217.         except:
  218.             if default==_marker: raise
  219.             return default
  220.  
  221.     restrictedTraverse__roles__=None # Public
  222.     def restrictedTraverse(self, path, default=_marker):
  223.         return self.unrestrictedTraverse(path, default, restricted=1)
  224.